home *** CD-ROM | disk | FTP | other *** search
/ Aminet 3 / Aminet 3 - July 1994.iso / Aminet / disk / misc / Mtools207.lha / Mtools-2.0.7 / docs / Mren.doc < prev    next >
Encoding:
Text File  |  1994-05-27  |  1.4 KB  |  45 lines

  1.  
  2. NAME
  3.        mren - rename an existing MSDOS file
  4.  
  5. SYNOPSIS
  6.        mren [ -v ] sourcefile targetfile
  7.  
  8. DESCRIPTION
  9.        Mren renames an existing file on an MSDOS filesystem.
  10.  
  11.        Mren will allow the following command line option:
  12.  
  13.        v      Verbose mode.  Display the new filename if the name
  14.               supplied is invalid.
  15.  
  16.        Reasonable care is taken to create a valid MSDOS filename.
  17.        If  an  invalid  MSDOS target name is specified, mren will
  18.        change the name (and prompt the user to accept  or  reject
  19.        the new name if the verbose mode is set).
  20.  
  21.        The path component of the target filename (if supplied) is
  22.        ignored.  In other words, you may not use mren to  move  a
  23.        file from one subdirectory to another.
  24.  
  25.        Mren may be used to rename directories.
  26.  
  27.        MSDOS subdirectory names are supported with either the '/'
  28.        or '\' separator.  The use of the '\' separator  or  wild-
  29.        cards  will  require the names to be enclosed in quotes to
  30.        protect them from the shell.
  31.  
  32.        The mcd command may be used to establish  the  device  and
  33.        the  current working directory (relative to MSDOS), other-
  34.        wise the default is A:/.
  35.  
  36.        Mread returns 0 on success or 1 on failure.
  37.  
  38. SEE ALSO
  39.        mcd(1)
  40.  
  41. BUGS
  42.        Unlike the MSDOS version of  REN,  mren  can  be  used  to
  43.        rename directories.
  44.  
  45.